/**
 * Copyright © 2016-2025 The Thingsboard Authors
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.terracloud.server.dao.device;

import com.terracloud.server.common.data.device.DeviceAccessControlMode;
import com.terracloud.server.common.data.device.DeviceAccessControlRule;
import com.terracloud.server.common.data.device.DeviceAccessControlRuleType;
import com.terracloud.server.common.data.id.DeviceAccessControlRuleId;
import com.terracloud.server.common.data.id.TenantId;
import com.terracloud.server.common.data.page.PageData;
import com.terracloud.server.common.data.page.PageLink;
import com.terracloud.server.dao.Dao;

import java.util.List;
import java.util.UUID;

public interface DeviceAccessControlRuleDao extends Dao<DeviceAccessControlRule> {

    /**
     * 保存设备接入控制规则
     *
     * @param rule 设备接入控制规则实体
     * @return 保存后的设备接入控制规则实体
     */
    DeviceAccessControlRule save(TenantId tenantId, DeviceAccessControlRule rule);

    /**
     * 查找所有设备接入控制规则列表
     *
     * @param pageLink 分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findAll(PageLink pageLink);

    /**
     * 根据文本搜索查找所有设备接入控制规则列表
     *
     * @param textSearch 文本搜索关键字
     * @param pageLink   分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByTextSearch(String textSearch, PageLink pageLink);

    /**
     * 根据规则类型和文本搜索查找所有设备接入控制规则列表
     *
     * @param type       规则类型
     * @param textSearch 文本搜索关键字
     * @param pageLink   分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByTypeAndTextSearch(String type, String textSearch, PageLink pageLink);

    /**
     * 根据访问控制模式和文本搜索查找所有设备接入控制规则列表
     *
     * @param mode       访问控制模式
     * @param textSearch 文本搜索关键字
     * @param pageLink   分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByModeAndTextSearch(DeviceAccessControlMode mode, String textSearch, PageLink pageLink);

    /**
     * 根据规则类型、访问控制模式和文本搜索查找所有设备接入控制规则列表
     *
     * @param type       规则类型
     * @param mode       访问控制模式
     * @param textSearch 文本搜索关键字
     * @param pageLink   分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByTypeAndModeAndTextSearch(String type, DeviceAccessControlMode mode, String textSearch, PageLink pageLink);

    /**
     * 根据规则类型查找所有设备接入控制规则列表
     *
     * @param type     规则类型
     * @param pageLink 分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByType(String type, PageLink pageLink);

    /**
     * 根据访问控制模式查找所有设备接入控制规则列表
     *
     * @param mode     访问控制模式
     * @param pageLink 分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByMode(DeviceAccessControlMode mode, PageLink pageLink);

    /**
     * 根据规则类型和访问控制模式查找所有设备接入控制规则列表
     *
     * @param type     规则类型
     * @param mode     访问控制模式
     * @param pageLink 分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByTypeAndMode(String type, DeviceAccessControlMode mode, PageLink pageLink);

    /**
     * 根据租户ID查找设备接入控制规则列表
     *
     * @param tenantId 租户ID
     * @param pageLink 分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByTenantId(UUID tenantId, PageLink pageLink);

    /**
     * 根据租户ID和文本搜索查找设备接入控制规则列表
     *
     * @param tenantId   租户ID
     * @param textSearch 文本搜索关键字
     * @param pageLink   分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByTenantIdAndTextSearch(UUID tenantId, String textSearch, PageLink pageLink);

    /**
     * 根据租户ID和规则类型查找设备接入控制规则列表
     *
     * @param tenantId 租户ID
     * @param type     规则类型
     * @param pageLink 分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByTenantIdAndType(UUID tenantId, String type, PageLink pageLink);

    /**
     * 根据租户ID、规则类型和文本搜索查找设备接入控制规则列表
     *
     * @param tenantId   租户ID
     * @param type       规则类型
     * @param textSearch 文本搜索关键字
     * @param pageLink   分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByTenantIdAndTypeAndTextSearch(UUID tenantId, String type, String textSearch, PageLink pageLink);

    /**
     * 根据租户ID和访问控制模式查找设备接入控制规则列表
     *
     * @param tenantId 租户ID
     * @param mode     访问控制模式
     * @param pageLink 分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByTenantIdAndMode(UUID tenantId, DeviceAccessControlMode mode, PageLink pageLink);

    /**
     * 根据租户ID、访问控制模式和文本搜索查找设备接入控制规则列表
     *
     * @param tenantId   租户ID
     * @param mode       访问控制模式
     * @param textSearch 文本搜索关键字
     * @param pageLink   分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByTenantIdAndModeAndTextSearch(UUID tenantId, DeviceAccessControlMode mode, String textSearch, PageLink pageLink);

    /**
     * 根据租户ID、规则类型和访问控制模式查找设备接入控制规则列表
     *
     * @param tenantId 租户ID
     * @param type     规则类型
     * @param mode     访问控制模式
     * @param pageLink 分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByTenantIdAndTypeAndMode(UUID tenantId, String type, DeviceAccessControlMode mode, PageLink pageLink);

    /**
     * 根据租户ID、规则类型、访问控制模式和文本搜索查找设备接入控制规则列表
     *
     * @param tenantId   租户ID
     * @param type       规则类型
     * @param mode       访问控制模式
     * @param textSearch 文本搜索关键字
     * @param pageLink   分页参数
     * @return 设备接入控制规则分页数据
     */
    PageData<DeviceAccessControlRule> findByTenantIdAndTypeAndModeAndTextSearch(UUID tenantId, String type, DeviceAccessControlMode mode, String textSearch, PageLink pageLink);

    /**
     * 根据租户ID和规则值查找设备接入控制规则
     *
     * @param tenantId 租户ID
     * @param value    规则值
     * @return 设备接入控制规则实体
     */
    DeviceAccessControlRule findByTenantIdAndValue(UUID tenantId, String value);
    
    /**
     * 根据规则值和类型查找设备接入控制规则
     *
     * @param value    规则值
     * @param type     规则类型
     * @return 设备接入控制规则实体列表
     */
    List<DeviceAccessControlRule> findByValueAndType(String value, DeviceAccessControlRuleType type);
}